home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / dialer.arc / DIALER.DOC < prev    next >
Text File  |  1987-08-04  |  25KB  |  538 lines
  1.               Welcome to state of the art BASIC programming!
  2.  
  3. This file is broken down into the following sections:
  4.  
  5.   1. Introduction
  6.   2. How to start DIALER.EXE
  7.   3. How to use DIALER.EXE
  8.   4. Information about the MicroHelp products used to create this program.
  9.   5. Ordering and shipping information for MicroHelp products (be sure to
  10.      check out the special prices on MicroHelp products in this area).
  11.   
  12.                        1. Introduction
  13.  
  14. DIALER.EXE allows you to have a "memory-resident" telephone dialing
  15. program that takes as little as 7K of DOS memory! The program requires
  16. an IBM or compatible computer with DOS 2.0 or later and uses either
  17. 7K or 117K of DOS memory (explained below). In addition, a 300 baud
  18. (or faster) modem that uses Hayes compatible commands, together with
  19. a phone line that accepts "tone dialing", is needed in order to dial
  20. the phone. If you don't have a modem, you can still use this program
  21. to pop up any text file you want!
  22.  
  23. You may have multiple copies of this program in memory at one time, but
  24. make sure each copy of the program has its own unique "hot key".
  25.  
  26. Note that this program will pop up over most any program that is
  27. running in text mode or CGA compatible graphics mode (16K memory
  28. used). It is not programmed to pop up over EGA graphics (it
  29. beeps at you), but Mach 2's routines can be used to do so - you
  30. just need more memory!
  31.  
  32. Along with DIALER.EXE, you should have received DIALER.BAS (the
  33. source code for DIALER.EXE), DIALER.DIR (starter dialing
  34. directory) and DIALER.DOC (this file). If you did not receive
  35. the source code, and you are interested in looking at it, you
  36. might want to check with the person/BBS/time sharing system
  37. where you obtained these files and find out why they did not
  38. include the source code. Note that the source code cannot be
  39. recompiled without two of MicroHelp's products. It is included
  40. so that you can get an idea of how our software works.
  41.  
  42. The program is yours to use absolutely free of charge. This is
  43. not "shareware" and no contribution is expected. Why? Simple -
  44. this program demonstrates two programmer's utility packages
  45. available from MicroHelp.  The packages are Mach 2 (assembler
  46. subroutine library) and Stay-Res (lets you make compiled BASIC
  47. programs memory-resident).
  48.  
  49. In order for this program to use only 7K of DOS memory, you must
  50. have DOS 3.0 or later and one of the following:
  51.  
  52.   a. Lotus/Intel/Microsoft Expanded Memory available for use
  53.   b. Any memory beyond 640k that you use as a RAM disk
  54.   c. A hard disk (a floppy is OK, but results in very slow popping up
  55.      and popping down).
  56.  
  57. If you have unused LIM Expanded memory (and DOS 3+), this
  58. program will use only 7K of memory without any action on your
  59. part. Using a RAM or hard disk for program storage is discussed
  60. in paragraph 2.e below.  (Without the above, the program
  61. requires about 117K.)
  62.  
  63.  
  64.                   2. How to start DIALER.EXE
  65.  
  66. In order to start DIALER, simply invoke its name from the DOS
  67. prompt, just like any other program. Because you do not have a
  68. configuration file (a file with the name DIALER.CNF), the
  69. configuration menu will be displayed on the screen.
  70.  
  71. If you did not get DIALER.DIR (starter dialing directory) or you
  72. have not yet prepared a file with the names and phone numbers of
  73. the people you want to call, you should press 'Esc' at this
  74. point, since the program will not become memory-resident without
  75. such a file.
  76.  
  77. The program needs to know the following information:
  78.  
  79.   a. Snow checking (toggle ON and OFF with the space bar)
  80.   
  81.      True Blue IBM Color Graphics Adapters generate "snow" on the screen
  82.      when programs write directly to video memory. The routines used
  83.      in DIALER (taken from Mach 2) write directly to video memory, but
  84.      are capable of suppressing the snow. So, if you have an IBM Color
  85.      Graphics Adapter you should set this to ON. If you are using a
  86.      monochrome monitor, or any other type of color adapater that does
  87.      not need snow suppression, set this to OFF.
  88.      
  89.   b. Monitor to use (toggle between DEFAULT, MONO and COLOR with space bar)
  90.   
  91.      This feature allows you to set the monitor on which DIALER will
  92.      pop up. Unless you have two monitors attached to your system,
  93.      set this to DEFAULT.
  94.      
  95.      If you have two monitors (monochrome and color), you may choose
  96.      the one on which DIALER will pop up or you may set it to DEFAULT.
  97.      If you set it to DEFAULT, DIALER will pop up on the currently 
  98.      active monitor. Setting this feature to COLOR or MONO will tell
  99.      DIALER to pop up on the appropriate monitor. This is handy when
  100.      you want to have your dialing directory pop up on the INACTIVE
  101.      monitor while viewing other information on the ACTIVE monitor.
  102.      
  103.   c. Phone directory file name
  104.   
  105.      Enter the name, which can include a disk drive and path. Note
  106.      that you have full use of the editing keys, since this input
  107.      is entered using Mach 2's input routine - you cannot use
  108.      Ctrl-Break or Ctrl-C to get out of this routine! You may
  109.      use the right and left arrow keys, Ins (to toggle the insert
  110.      status), Home, End, Ctrl-End (delete from cursor to end of
  111.      line) keys. These keys all behave the same way they do in
  112.      most word processors and the BASIC interpreter.
  113.      
  114.      Examples:
  115.      
  116.        C:\PHONE.DIR
  117.        C:\PHONE\DIRECTORY.DTB
  118.        B:NOTES
  119.        PHONENUM
  120.        
  121.      The normal DOS filename restrictions apply here. In other words,
  122.      it must be a valid DOS file name, without wildcards of '*' and '?'.
  123.             
  124.      The file name that you choose must be a TEXT file (created with
  125.      a text editor) with one entry per line and each line terminated
  126.      with a carriage return/line feed. That's CHR$(13)+CHR$(10). Most
  127.      text editors, including EDLIN, create that kind of file. You may
  128.      also use Wordstar (non-document mode) or SideKick's note pad.
  129.      Even the QuickBASIC 2 and 3 editors create this kind of file!
  130.      
  131.      Each entry (up to 200) can be as long as you like, but only the first 76
  132.      characters will be used by DIALER.
  133.      
  134.      The phone numbers that you want DIALER to dial for you must begin
  135.      in column 56 (or higher) of the entry. Any entry that has nothing
  136.      but spaces in it from column 56 onward will not be dialed.
  137.      
  138.      The data in your file might look like this:
  139.      
  140. MicroHelp order line (outside of Georgia)              1-800-922-3383
  141. MicroHelp tech support line (and orders in Georgia)    1-404-973-9272
  142. Microsoft Customer Service                             1-206-882-8088
  143.   (upgrades, tech support, etc.)
  144. Microsoft Tech support - on Compuserve, type GO MSOFT
  145. Compuserve customer service                            1-800-848-8990
  146. Tall tree Tech support (JRAM boards)                   1 (415) 424-8324
  147. Softcraft Inc. (Btrieve)  BBS                          1-512-346-8385
  148.      
  149.      Note that the phone numbers begin in column 56 and that spaces,
  150.      hyphens and parenthesis are OK to use - your modem will ignore
  151.      those characters.               
  152.  
  153.      Whenever you pop up this program, your telephone directory file
  154.      is checked for the time and date. If you have changed the file,
  155.      DIALER will reload it for you automatically.
  156.  
  157.   d. Press your hot key
  158.   
  159.      You can select the "hot key" that you want to pop up your program.
  160.      (This is a standard feature in Stay-Res. In addition, Stay-Res
  161.      lets you pop up your programs with a POKE!)
  162.  
  163.      You will be able to pop up over most any program running in text
  164.      mode or CGA compatible graphics mode. With Mach 2's routines,
  165.      you can write programs that pop up over EGA graphics too!
  166.      
  167.      For this demonstration, you must hold one or more of the CTRL, ALT
  168.      and SHIFT keys and then press another key (Stay-Res does not require
  169.      this, but since the "general public" is using this program, it prevents
  170.      them from accidentally assigning their hot key to a "normal" key.)
  171.      
  172.      If we wanted to be fancy (and make the program take more memory), 
  173.      we would display the actual key that you press. But in order to
  174.      save memory, we only show you the "scan code" and "shift status"
  175.      of your hot key.
  176.      
  177.      Example hot keys are:
  178.      
  179.        SHIFT-F10
  180.        ALT-F3
  181.        CTRL-ESC
  182.        SHIFT-ALT-F10
  183.  
  184.      Once you have chosen your hot key, you may press F1 to save your
  185.      configuration file and become memory-resident if you do not need
  186.      to set the other two items (below).
  187.        
  188.   e. Drive/path for swapping
  189.   
  190.      If you have DOS 3.0 or later, plus either a RAM or hard disk, you
  191.      may use the "disk swapping" facility that is included in the
  192.      EMS/Disk module available as an "add-on" for Stay-Res.
  193.      
  194.      What you do is to enter a disk drive letter (and optional subdirectory)
  195.      that Stay-Res can use for file storage. Do NOT enter a file name.
  196.      Examples of what you should enter:
  197.      
  198.        C:\DIALER
  199.        C:\
  200.        E:\RAM\WORK
  201.        
  202.      What happens with Disk swapping? When DIALER becomes memory-resident,
  203.      it saves a binary "image" of your program to a disk file on the drive
  204.      and path you specify. It creates another empty file at the same time.
  205.      
  206.      When you press your hot key, Stay-Res checks to make sure that it is
  207.      safe to use DOS (if you are in the middle of doing disk I/O it is 
  208.      NOT safe - almost any other time is safe). If it is NOT safe to use
  209.      DOS, DIALER will BEEP at you and will NOT pop up (SideKick performs
  210.      a similar check and "squeaks" at you if it's not safe to pop up.)
  211.      
  212.      If it is safe to use DOS functions, Stay-Res will save a binary
  213.      "image" of the data that is in the memory locations it needs to use,
  214.      then it will reload the binary image of DIALER into memory, take
  215.      a "snapshot" of the screen and transfer control to DIALER.
  216.      
  217.      When you put the program "back to sleep", waiting for the next press
  218.      of the "hot key", the reverse takes place - the screen is restored,
  219.      DIALER is saved to disk and the original program (or DOS) is given
  220.      control again.
  221.  
  222.      When you use the disk swapping capabilities of Stay-Res, two files
  223.      will be created on the drive and path you specify. Normally these
  224.      files are named "SR00" and "SR01". However, if those file names are
  225.      in use, you will see files "SR02" and "SR03" or any other pair up
  226.      to "SR99". DO NOT DELETE these files while DIALER is memory-resident!
  227.      
  228.   f. Communications port
  229.   
  230.      Use the space bar to toggle between COM1 and COM2.
  231.      
  232. After you have entered all of the necessary configuration data, press
  233. the F1 key to save your configuration and become memory-resident.          
  234.  
  235. Once you have saved your configuration, it will automatically be loaded
  236. next time you invoke DIALER (note that the configuration file, DIALER.CNF
  237. must be present in the current directory on the default disk drive when
  238. you invoke DIALER.)
  239.  
  240. If you need to change your configuration, simply start DIALER like this:
  241.  
  242.   DIALER/C
  243.   
  244. The /C tells DIALER that you want to change your configuration.
  245.  
  246.   
  247.                      3. How to use DIALER.EXE
  248.  
  249. When the program pops up, the data from your telephone directory (a maximum
  250. of 200 entries) will be available to you. DIALER will display up to 20
  251. entries at once on the screen, with one entry being highlighted.
  252.  
  253.   a. Select someone to call
  254.   
  255.      You may move through your entries using the following keys:
  256.  
  257.      Up arrow moves upward on the current screen. If you press the up arrow
  258.      key while at the first entry on the screen, you will move to the last
  259.      entry on the screen.
  260.   
  261.      Down arrow moves downward on the current screen. If you press the down
  262.      arrow key while on the bottom entry of the screen, you will move to the
  263.      first entry on the screen.
  264.   
  265.      Use the PgUp key to move BACKWARD one screen and the PgDn key to move
  266.      FORWARD one screen. Both of these keys will "wrap" around. In other words,
  267.      if you press the PgDn key while the end of your telephone directory is
  268.      on the screen, the next screen displayed will be the FIRST screen of
  269.      your file.
  270.  
  271.   b. Dial a number
  272.   
  273.      In order to dial the number of the highlighted entry, simply press the
  274.      Enter key (also called Return). After you dial a number, what happens next
  275.      is up to you:
  276.  
  277.      Press the 'R' key to redial the number. Do this if the line is busy or
  278.      you get the "busy circuit" signal (fast repeats of the busy tone).
  279.   
  280.      Press the Enter key again to "hang up" and return to the main menu
  281.      prompt. Note that if you wish to speak to the person that answers the
  282.      phone, you must pick up your telephone handset (or turn on your speaker
  283.      phone) BEFORE you press Enter!
  284.   
  285.   c. Go back to sleep
  286.   
  287.      Press the 'Esc' key to put DIALER back to sleep, waiting for the next
  288.      press of your hot key.
  289.      
  290.   d. Disappear from memory
  291.   
  292.      WARNING - you must not do this if any other program is running or if
  293.      you have loaded any other memory-resident programs AFTER you loaded
  294.      DIALER!
  295.      
  296.      Selecting this option will remove DIALER from memory, returning all
  297.      memory used by DIALER back to DOS.
  298.      
  299.      Since it is dangerous to do this at the wrong time, DIALER will ask
  300.      you to confirm that you want to release memory before doing so.
  301.      
  302.   e. Search phone directory.
  303.   
  304.      Press the 'F3' to search your phone directory for any characters
  305.      you want. You may enter up to 50 characters.
  306.      
  307.      Note that the search will ignore the case of characters. That means
  308.      that if you enter 'abc' as the characters to search for, all of the
  309.      following would be found:
  310.      
  311.        ABC Television
  312.        abc Movie
  313.        aBc Tape
  314.   
  315.   4. Information about the MicroHelp products used to create this program.
  316.      
  317.      MicroHelp products are not copy protected and there are no royalties
  318.      when you use MicroHelp products in your compiled programs. To order
  319.      any products, or to receive more detailed information about MicroHelp
  320.      products, call 1-800-922-3383. In Georgia, or to receive answers to
  321.      technical questions by phone, call 404-973-9272. 
  322.      
  323.      All MicroHelp products come with a 30 day money-back performance
  324.      guarantee - if our software doesn't do what we say, and we don't fix
  325.      it, you get your money back.
  326.      
  327.      All products come with a manual in a three ring binder and include
  328.      sample programs on the accompanying disk(s). The prices shown below
  329.      do not include shipping and handling (see the end of this file).
  330.      
  331.   a. Stay-Res
  332.   
  333.      Allows you to make your compiled BASIC programs memory-resident, just
  334.      like this program. You select the "hot key" to use (or call up your
  335.      programs with a POKE) and Stay-Res does the rest.
  336.      
  337.      The suggested retail price is only $69. The EMS/Disk module (allowing
  338.      your programs to use only 7K of DOS memory) is $30 if purchased with
  339.      Stay-Res. If you purchase it later, the cost is $50.
  340.      See the end of this file for ordering info.
  341.      
  342.      Stay-Res is compatible with Microsoft QuickBASIC (all versions) but
  343.      programs compiled with QuickBASIC 2+ require DOS 3.x to run. In 
  344.      addition, Stay-Res works with IBM BASCOM 1.0 and 2.0 as well as
  345.      Microsoft's "generic" compiler version 5.36.
  346.      
  347.      Stay-Res comes in the form of an .obj module that you LINK on to
  348.      the front of your program. Inside your program, you have one or
  349.      more CALL statements that reference Stay-Res.
  350.      
  351.      You must have the BASIC source code for any program you want to become
  352.      memory-resident. In addition, the program must be compiled as a
  353.      "standalone" program (using the /O switch) and cannot use the
  354.      /d, /v and /w switches.
  355.      
  356.      There is no limit on your program size with QuickBASIC and BASCOM 2.0.
  357.      
  358.      Stay-Res is compatible with and can be popped up over SideKick,
  359.      Superkey, Microsoft Word, Lotus 1-2-3, the BASIC interpreter,
  360.      QuickBASIC (except version 2.01) and any other program that does not
  361.      "steal" the keyboard interrupt (INT 9H).
  362.      
  363.      The only reported incompatibility we've had with Stay-Res is
  364.      DesqView - the reason is simple - both programs are trying to accomplish
  365.      the same thing and do it in a similar fashion.
  366.      
  367.      Stay-Res includes the following features:
  368.      
  369.       1. Automatic screen save (when you pop up) and restore (when you pop
  370.          back down) for text and 16K graphics modes. Mach 2 can save
  371.      EGA graphics images if you need to pop up over EGA graphics screens.
  372.       2. Screen images can be saved inside BASIC's string space (if you have
  373.          room) or outside of BASIC's data area if not.
  374.       3. Selectable hot key, including shift status.
  375.       4. "Snow checking" during screen save and restore can be on or off.
  376.       5. Programs can be popped up with a POKE from another program.
  377.       6. Change the video mode independent of BASIC.
  378.       7. True SHELL facility (before or instead of becoming resident). Allows
  379.          use of SHELL with all the compatible compilers shown above, including
  380.      SHELL'ing other BASIC programs (compiled or interpreted).
  381.       8. Ability to remove the resident program from memory, returning all
  382.          used memory back to DOS.
  383.       9. Multiple Stay-Res assisted programs can be in memory at the same time
  384.          (but each one must have a unique hot key).     
  385.  
  386.      The EMS/disk module (DOS 3+) provides these additional features:
  387.      
  388.       1. Use Lotus/Intel/Microsoft expanded memory for program storage -
  389.          your program takes only 7K of DOS memory. EMS memory, if present,
  390.      will automatically be used for program storage but you can tell
  391.      Stay-Res NOT to use it if you wish.
  392.       2. Allows use of RAM or hard disk for program storage - your program
  393.          takes only 7K of DOS memory.
  394.       3. Determine if sufficient EMS memory is available before becoming
  395.          resident.                    
  396.      
  397.   b. Mach 2 - Performance package for the BASIC programmer
  398.   
  399.      This library of assembler subroutines is MicroHelp's most popular
  400.      product. No knowledge of assembly language is needed, nor is an assembler
  401.      program required in order to use Mach 2.
  402.      
  403.      There are over two dozen specialized subroutines in the package including
  404.      support for string data beyond the 64K limit in compilers and
  405.      interpreters. Mach 2 even lets you use LIM Expanded Memory for data
  406.      storage!
  407.      
  408.      The suggested retail price is only $69.00.
  409.      See the end of this file for ordering info.
  410.      
  411.      In addition to being compatible with the same compilers as Stay-Res,
  412.      Mach 2 is compatible with Microsoft Business BASIC. Versions are also
  413.      available (at the same price) for Turbo Basic and Turbo Pascal.
  414.  
  415.      All of the video related routines allow you to select the monitor to
  416.      use (including Multilink video segments) and you can specify if 
  417.      snow checking is necessary on a color monitor.
  418.  
  419.      All file and directory related routines return true DOS error codes
  420.      without your having to use ON ERROR.
  421.      
  422.      The routines included in Mach 2 are:
  423.      
  424.                              Video and Input Routines
  425.        -------------------------------------------------------------------
  426.        Mhscr    - Instant screen display (when compiled) - about 4 times
  427.                   faster in interpreted BASIC. When we say "instant", we
  428.           mean that you can display an entire screen in 0.1 to 0.2
  429.           seconds when compiled.
  430.        Mhwindow - the Window manager - pop 'em up, pull 'em down or do them
  431.                   like Lotus 1-2-3. This routine saves and restores any
  432.           portion (or all) of the screen and draws boxes (single
  433.           or double line) automatically.                    
  434.        Mhscrol  - scrolls data on the screen in all four directions
  435.        Mhchars  - displays characters 5 lines tall by 4 columns wide
  436.        Mhpusing - similar to BASIC's PRINT USING for numbers, but more 
  437.                   flexible and up to 6 times faster
  438.        Mhrscr   - reads characters from the screen into a BASIC string up
  439.                   to 150 times faster than BASIC's SCREEN(x,y) function.
  440.        Mhscatt  - changes screen attributes (colors) without disturbing
  441.                   the text on the screen - instantly.
  442.  
  443.        * * * Both of the following routines return the scan code, ASCII
  444.              code and shift status (SHIFT/CTRL/ALT) of the last key pressed.
  445.        
  446.        Mhinput  - the controlled input routine used in DIALER for getting
  447.                   your phone directory name and disk swapping information.
  448.           Allows full use of standard editing keys and ignores
  449.           Ctrl-C and Ctrl-Break.
  450.        Mhkclr   - clears the keyboard before returning a single key press                        
  451.        
  452.  
  453.                          Beyond the BASIC 64K data limit
  454.              
  455.                   (Use all available DOS and LIM Expanded Memory)
  456.        -------------------------------------------------------------------
  457.  
  458.        Mhems    - manages LIM Expanded Memory for data storage
  459.        Mhstore  - stores and retrieves data in memory outside of BASIC's
  460.                   data areas
  461.        Mhmove   - copies memory from any location to any RAM location
  462.        Mhmsort  - sorts string arrays stored outside of BASIC's string space
  463.        Mhorder  - maintains sorted arrays outside of BASIC's string space. 
  464.                   Lets you find, insert and delete strings automatically.
  465.        Mhsrch   - search any part of the computer's memory for a string
  466.  
  467.                             File & Directory Services
  468.        -------------------------------------------------------------------
  469.  
  470.        Mhenvir  - searches the DOS "path" for a given file name
  471.        Mhfdate  - get or set a file's date and time
  472.        Mhattr   - get or set a file's attributes (read-only, hidden,
  473.                   system, archive)
  474.        Mhdir    - get/set current drive/directory. Create/remove
  475.                   and change directories
  476.        Mhfile   - opens files and devices for I/O
  477.        Mhfind   - searches any drive/directory for matching file names,
  478.                   including wild card searches
  479.        Mhfsize  - get's a file's size
  480.        Mhrwsub  - reads and writes files as fast as DOS - do it up to
  481.                   65535 bytes in one operation
  482.        Copyfile - ready to run subroutine for copying files as fast as DOS
  483.  
  484.                                  String Handling
  485.        -------------------------------------------------------------------
  486.        Mhucase  - converts strings to uppercase
  487.        Mulcase  - converts strings to lowercase
  488.        Mhsndx   - lets you compare strings by their SOUND - yes we said SOUND
  489.        Mhstrip  - replaces unwanted characters in a string
  490.  
  491.                                   Miscellaneous
  492.        -------------------------------------------------------------------
  493.  
  494.        Mhdos2   - DOS/BIOS function calls and interrupts
  495.        Mhdver   - returns the DOS version number
  496.        Mhround  - rounds numbers to the desired number of decimal places
  497.  
  498.                   5. Ordering and shipping information
  499.         
  500. To order any of MicroHelp's products, call 1-800-922-3383. In
  501. Georgia, or for technical questions, call 404-973-9272. We
  502. welcome VISA, MasterCard and COD orders (COD in USA only - $3
  503. charge). Our current products and their prices are shown below.
  504.  
  505. Please add shipping and handling (shown after the price info) and if
  506. you live in Georgia, please add sales tax for your county.
  507.  
  508.                                                 Retail
  509.                         Price 
  510.                         ------
  511.       Mach 2 for IBM/Microsoft BASIC            $69.00
  512.       Stay-Res                                   69.00
  513.       Stay-Res with EMS/Disk Module              99.00
  514.         EMS/Disk module purchased separately     50.00
  515.       Mach 2 for Turbo Pascal                    69.00
  516.       Mach 2 for Turbo Basic                     69.00
  517.       Screen Machine                             79.00
  518.       Peeks 'n Pokes                             30.00
  519.       The Inside Track                           45.00
  520.  
  521. Shipping & Handling Charges:
  522.  
  523.                                   USA
  524.    ----------------------------------------------------------------------  
  525.    UPS ground shipping $3.00 per order (any number of software packages)
  526.    UPS Blue label $5.00 for one software package. Call for prices on more
  527.        items in the same order.
  528.    UPS Red label $14.00 for one software package. Call for prices on more
  529.        items in the same order.
  530.  
  531.                        Canada (Shipped via Air mail)
  532.    ----------------------------------------------------------------------  
  533.    $5.00 for one or two software packages. $2.00 each additional package.
  534.    
  535.                    Other countries (Shipped via Air mail)
  536.    ----------------------------------------------------------------------  
  537.    $18.00 for one or two software packages. $7.00 each additional package.           
  538.